###Function###
GUIGetMsg

###Description###
Fragt die GUI nach aufgetretenen Ereignissen (events) ab.

###Syntax###
GUIGetMsg ( [advanced = 0] )


###Parameters###
@@ParamTable@@
advanced
	[optional] gibt evtl. zustzliche Informationen in einem Array zurck.
		0 = (Standard) Gibt nur das Ereignis selbst zurck.
		1 = Gibt ein Array zurck, in dem das Ereignis und zustzliche Informationen enthalten sind.
@@End@@

###ReturnValue###
Gibt je nach "advanced"-Parameter ein Ereignis oder ein Array zurck.

Das zurckgegebene "Ereignis" ist die Control-ID des Controls, das die Nachricht sendet, oder es ist ein spezielles Ereignis (wie das Schlieen oder Minimieren eines Fensters). Wenn keine Nachricht vorhanden ist, wird 0 als Ereignis zurckgegeben.

@@ReturnTable@@
<b>Spezial ID</b>	<b>Bemerkungen</b>
0	Kein Ereignis
$GUI_EVENT_CLOSE	die Dialogbox wird geschlossen (entweder durch einen bestimmten Button oder das Systemmen).
$GUI_EVENT_MINIMIZE	die Dialogbox wird per Button in der Titelleiste minimiert.
$GUI_EVENT_RESTORE	die Dialogbox wird durch Klick auf das Taskleistensymbol wiederhergestellt.
$GUI_EVENT_MAXIMIZE	die Dialogbox wird per Button in der Titelleiste maximiert.
$GUI_EVENT_MOUSEMOVE	der Mauszeiger wurde bewegt
$GUI_EVENT_PRIMARYDOWN	die erste (linke) Maustaste wurde gedrckt
$GUI_EVENT_PRIMARYUP	die erste (linke) Maustaste wurde losgelassen
$GUI_EVENT_SECONDARYDOWN	die zweite (rechte) Maustaste wurde gedrckt 
$GUI_EVENT_SECONDARYUP	die zweite (rechte) Maustaste wurde losgelassen
$GUI_EVENT_RESIZED	Dialogbox wurde neu aufgebaut.
$GUI_EVENT_DROPPED	Ende der Drag&Drop Aktion @GUI_DragId, @GUI_DragFile und @GUI_DropId werden verwendet, um die ID's bzw. Dateien der jeweiligen Controls zu ermitteln.
@@End@@

Wird der "advanced"-Parameter verwendet, werden die Informationen in einem Array zurckgegeben:

$aArray[0] = 0 oder Ereignis-ID oder Control-ID
$aArray[1] = Der Fenster-Handle des Fensters, von dem das Ereignis gemeldet wird
$aArray[2] = Der Control-Handle des Controls, von dem das Ereignis gemeldet wird (gegebenenfalls)
$aArray[3] = Die aktuelle X-Position des Mauszeigers (relativ zum GUI-Fenster)
$aArray[4] = Die aktuelle Y-Position des Mauszeigers (relativ zum GUI-Fenster)

Wenn die GUIOnEventMode-Option auf 1 gesetzt ist, ist der Rckgabewert von GUIGetMsg immer 0, und @error wurde auf 1 gesetzt.

Falls die Option GUIEventOptions auf 1 gesetzt ist, wird der Minimier-, Wiederherstell- und Maximier-Button nichts weiter tun, auer einer einfachen Benachrichtigung.


###Remarks###
Diese Funktion gibt die CPU automatisch wieder frei, wenn es erforderlich ist, so dass sie ruhig in Dauerschleifen benutzt werden kann, ohne die CPU vollstndig auszulasten. 

Informationen ber die Mausposition und das berfahren von Controls kann mit <a href="GUIGetCursorInfo.htm">GUIGetCursorInfo()</a> ermittelt werden. Befindet sich die Maus ber einem Control, wird kein Ereignis ausgelst. Deshalb muss <a href="GUIGetCursorInfo.htm">GUIGetCursorInfo()</a> eingesetzt werden, um die Control-ID zu erhalten.

<a href="../guiref/GUIRef.htm">- - - - - - - - Erklrung der Controls - - - - - - - -</a>


###Related###
GUICreate, GUICtrlCreate..., GUICtrlRead, GUIOnEventMode (Option), GUIEventOptions (Option), GUIGetCursorInfo, GUICtrlSendMsg, GUICtrlSetOnEvent


###Example###
@@IncludeExample@@
